package com.shengchao.examstar.rpc.question.api;

import com.shengchao.examstar.rpc.question.req.SpecialPracticeGenerateReq;
import com.shengchao.examstar.rpc.question.resp.SpecialPracticeResp;
import com.shengchao.examstar.rpc.question.resp.SpecialPracticeIdsResp;

/**
 * 专项练习RPC接口
 * 提供专项练习的生成、管理等功能
 */
public interface ISpecialPracticeRpc {

    /**
     * 生成专项练习
     * 1. 调用Dify生成题目
     * 2. 生成专项练习题集
     * 3. 将题目关联到题集
     * 
     * @param request 专项练习生成请求
     * @return 专项练习响应信息
     */
    SpecialPracticeResp generateSpecialPractice(SpecialPracticeGenerateReq request);
    
    /**
     * 根据知识点ID和用户ID获取专项练习题集ID列表
     *
     * @param knowledgeId 知识点ID
     * @param userId 用户ID
     * @return 专项练习题集ID列表响应
     */
    SpecialPracticeIdsResp getSpecialPracticeIdsByKnowledge(Long knowledgeId, Long userId);

}